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OPINT  SYSTEM  SPECIFICATION 


1 . 0  INTRODUCTION 


1.1  Purpose  of  the  System  Specification 

,\ 

The  OPINT  System  Specification  is  a  technical  document 
written  for  software  development  personnel.  Together  with 
the  OPINT  Functional  Description,  it  guides  the  software 
development  effort  by  identifying  the  functional  requirements 
and  by  providing  structured  logic  diagrams  that  depict  the 
flow,  control,  and  processing  of  information  within  the 
system. 

The  system  specification  is  generic  and  is  intended  to 
guide  and  facilitate  the  preparation  of  the  language-specific 
program  documentation  and  coding  that  are  necessary  to  imple¬ 
ment  and  operate  OPINT  at  an  installation. 

/ 

1.2  References 


1.2.1  IBM,  HIPO — A  Design  Aid  and  Documentation  Tech¬ 
nique.  Technical  Publication  GC20-1951-0. 

White  Plains,  New  York:  IBM,  October  1974. 

1.2.2  Amey,  Dorothy  M. ?  Feuerwerger,  Phillip  H. ; 

Gulick,  Roy  M.  Documentation  of  Decision-Aiding 
Software:  OPINT  Functional  Description.  McLean , 
Virginia:  Decisions  and  Designs,  Inc.,  April 

1979. 

1.2.3  Amey,  Dorothy  M.;  Feuerwerger,  Phillip  H. ; 

Gulick,  Roy  M.  Documentation  of  Decision-Aiding 
Software:  OPINT  Users  Manual.  McLean,  Virginia: 
Decisions  and  Designs,  Inc.*  April  1979. 
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1.3 


Terms 


vr 
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1.3.1  OP I NT  -  OPINT  is  an  abbreviation  for  Operations 
and  Intelligence,  reflecting  the  system's  major  area  of 
applicability. 

1.3.2  HIPO  -  The  specification  uses  the  standard  Hier¬ 
archy  plus  Input-Process-Output  (HIPO)  diagramming  technique 
to  depict  the  structural  design  and  logical  flow  of  the 
system.  A  legend  explaining  the  HIPO  diagramming  symbols  is 
included.  Reference  1.2.1  provides  a  complete  description 
of  the  HIPO  documentation  technicue. 
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2.0  DESIGN  DETAILS 


2.1  Background 

Systems  development  personnel  should  refer  to  the  OPINT 
Functional  Description ,  Reference  1.2.2,  in  coniunction 
with  the  documentation  contained  in  this  specification.  The 
functional  description  details  the  decision  model  implemented 
by  OPINT  and  discusses  the  specific  functions  that  the  soft¬ 
ware  performs.  In  addition,  systems  development  personnel 
may  wish  to  refer  to  the  OPINT  User's  Manual,  Reference  1.2.3. 

2.2  General  Operating  Procedures 


OPINT  is  a  menu-driven  system.  That  is,  the  system  is 
designed  to  interact  with  the  user  by  presenting  a  sequential 
hierarchy  of  menus  and  asking  the  user  to  resnond  by  selecting 
one  option  from  the  current  menu.  If  the  user  does  not  select 
one  of  the  menu  options,  the  system  displays  the  previous 
menu.  In  this  manner,  the  user  moves  up  and  down  the  hier¬ 
archy,  as  desired.  Whenever  data  entry  is  required  as  a 
result  of  option  selection,  the  system  specifically  requests 
the  data  and  specifies  the  format. 

The  system  is  also  designed  to  be  generally  forgiving 
of  procedural  errors  by  the  user. 

2. 3  System  Logical  Flow 

OPINT  is  a  hierarchically  structured,  modular  system. 

The  system  structure  and  logical  flow  lends  itself  to  pre¬ 
sentation  in  the  form  of  HIPO  diagrams,  which  are  contained 
in  this  document. 


The  main  purpose  of  the  HIPO  diagrams  is  to  provide,  in 
a  pictorial  manner,  the  complete  set  of  modular  elements 
necessary  to  the  operation  of  OPINT  including  all  input, 
output,  and  internal  functional  processing.  This  is  done  by 
displaying  input  items  to  the  process  step  which  uses  them, 
defining  the  process,  and  showing  the  resulting  output  of 
the  process  step. 

The  documentation  diagrams  are  designed  and  drawn  in  a 
hierarchical  fashion  from  the  main  calling  routines  to  the 
detail-level  operation/calculation  routines.  Extended 
written  descriptions  are  given  below  a  HIPO  diagram  whenever 
it  is  deemed  necessary. 

A  complete  explanation  of  the  symbolic  notation  used  in 
the  HIPO  diagrams  is  given  in  Reference  1.2.1.  An  abbreviated 
legend  for  the  symbols  used  in  this  specification  is  given 
in  Figure  2-1.  Note  that: 

a.  External  subroutines  appear  partly  in  the  process 
block  and  partly  out.  Internal  subroutines  are 
shown  within  the  process  block. 

b.  Overview  diagrams  show  general  inputs  and  outputs 
only,  whereas  detail/subroutine-level  diagrams 
show  specific  input/output  tables  and/or  displays. 

c.  Rectangular  boxes  inside  the  input/output  block 
areas  are  generally  used  to  denote  single  data 
items.  Two  or  more  boxes  are  grouped  to  show 
several  data  items  are  input/output. 

d.  Rectangular  boxes  inside  the  process  block  indi¬ 
cate  repetitive  subprocesses. 
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LEGEND  OF  HIPO  SYMBOLS 


IV 


The  HIPO  diagrams  appear  in  the  next  section,  which 
completes  the  system  specification. 

2.4  HIPO  Documentation 

The  HIPO  diagram  identification  numbers  and  figure 
numbers  used  in  this  section  stand  alone?  i.e.,  they  start 
with  1.0,  increase  hierarchically,  and  are  independent  of 
the  numbering  scheme  used  to  this  point  in  this  document. 

Figure  2-2  is  a  system  structure  chart  and  represents 
the  overall  program  logic  flow  in  a  visual  table  of  contents. 
The  Visual  Table  of  Contents  diagram  shows  the  hierarchical 
structure,  the  functional  description  labels,  and  the  diagram 
(chart)  identifiers  of  functions  of  OPINT. 
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OPINT  OVERVIEW  CHART  AND  VISUAL  TABLE  OF  CONTENTS 


System/Program:  OP*NT _  Name:  _ 

Diagram  ID:  2:fl - Description  — Load  An  OPINT  Model -  Page: 
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System  PfriQiam  OPINT _  Name:  LOADYARS  _ 

Diagram  ID:  -^2 -  Description Load  A  Model - - - _ — _ _ _ _ _ _ _  Page: 
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MODEL  -  -  EVACUATION 
EXPECTED  VALUE 


NONE 

P-300 

P-2K 

NP-2K 

NP-6K 

TOTAL 

NORMAL 

0 

0 

-4 

-13 

-10 

-28 

LOW  PROF 

-5 

0 

-2 

-12 

-10 

-29 

MED  PROF 

-12 

-1 

-3 

-5 

-5 

-26 

EVAC  PST 

-15 

-1 

-4 

-4 

-4 

-28 

Figure  3.1 

EXAMPLE  OF  OUTPUT  FROM  DISPLAY  FUNCTION  3.1 


14 


NORMAL 
LOW  PROF 
MED  PROF 
EVAC  PST 


MODEL  -  -  EVACUATION 


COMBINED  VALUE 


NONE 

P-300 

P-2K 

NP-2K 

NP-6K 

0 

-17 

-31 

-74 

-74 

-9 

-9 

-17 

-71 

-71 

-24 

-22 

-22 

-30 

-32 

-30 

-26 

-26 

-26 

-26 

Figure  3.2 

EXAMPLE  OF  OUTPUT  FROM  DISPLAY  FUNCTION  3.2 


.  The  display  heading  should  include  the  Model  name. 


-  Name:  _ 

Description  Display  Regret  Matrices 


3,4.  The  requested  matrix  is  displayed  along  with  the  appropriate  alternative, 
outcome,  and  criterion  labels.  (SHOWMAT.  Chart  8. 1 ) 


Svstem/Program : _ ^**I|S*T _  Name:  _ 

Diagram  10:  _ 12 _ Description _ Revise  the  Current  Model 


System/Program: _  Name:  _ 

Diagram  ID:  _ i 1 _  Descrip., on  ■  ,jdit_the  Probabilities 


3.  The  updates  which  are  input  by  the  user  are  normalized  (divided  by  the  sum  5.  After  all  corrections  are  made  to  the  updated  values,  the  current  set  of 

of  the  updates  and  then  multiplied  by  1001  to  sum  to  100.  The  resulting  outcome  probabilities  is  permanently  updated, 

numbers  are  displayed  below  the  input  values. 


System  Program. _ _  Name:  _ 

Diagram  10  _ i 1 _ Description gaitO^Cofr^inedA^alue  Matrix 


2.  This  step  begins  an  iterative  process.  The  user  is  prompted  for  the  name  of 
the  row  (alternative)  or  column  (outcome)  to  be  updated.  If  no  name  is 
specified,  then  the  process  ends.  Otherwise,  steps  3-6  are  executed. 

6.  The  input  update  values  are  used  to  permanently  change  (until  later  updates 
to  regrets  or  criteria  weights)  the  combined-value  regrets. 


inal  corrections  to  the  updates  are  used  to  permanent'-, 
criteria  weights. 


System/Program:  _ _ _  Name:  _ 

Diagram  ID:  _ _  Description.  Add  An  Alternative 


2.  For  each  criterion,  prompt  the  user  lor  numerical  regret  value  input.  This  i: 
done  by  displaying  the  event  outcome  labels  horizontally  to  remind  the  user  o 
the  Matrix  cell  position  and  prompting  values  along  the  outcomes  for  the  new 
alternative. 
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t.  Display  the  label  types  which  can  be  modified  in  a  Menu  list.  Prompt  the  user 
for  the  type  desired.  If  no  valid  response,  then  return  to  the  calling  routine. 
Otherwise  do  steps  2-5. 

5.  At  this  step  labels  are  permanently  modified  for  the  operating  program. 


Description  Saw  the  Current  Model _ _ _ _ _  Page: 


4.  The  existing  file  structure  and  the  amount  of  available  space  on  the  data  tape 
are  checked  along  with  the  user  specification  to  determine  where  the  model 
variables  are  to  be  stored. 


Description  Save  the  Current 


me  list  is  updated  to  reflect  the  new  file  structure.  The  new 
sition  in  the  LIBNAMES  array  must  be  the  same  relative 
models  stored  on  the  device. 


System/Program: _ _  Name:  FILELOC 

Diagram  ID:  _ §J _  Descnption  ,  L°la.tion _ 


30 


31 


System  Program: _ PRINT _  Name:  SAVLIB 

Diagram  ID  _ _  Descr.pt, on  the  LibfarV  Names 
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MANUALLY  CHANGE  PROBS  -  EVACUATION 


NONE 

P-300 

P-2K 

NP-2K 

NP-6K 

CURRENT PROBS 

(TRIAL  0) 

53 

6 

14 

17 

1 

PROBS.  TRIAL  1 

1 

1 

1 

1 

1 

NORMALIZED 

20 

20 

20 

20 

20 

PROBS,  TRIAL  2 

10 

1 

5 

6 

5 

NORMALIZED 

37 

4 

19 

22 

19 

PROBS.  TRIAL  3 

20 

1 

5 

6 

5 

NORMALIZED 
PROBS.  TRIAL  4 

54 

3 

14 

16 

14 

Figure  6.1  -A 

SENSITIVITY  ANALYSIS: 

EXAMPLE  OF  USER-INTERACTIVE  DISPLAY  OUTPUT 


NOTE:  Underlined  velues  indicate  user  terminal  input 

r 

| 

f 
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MANUALLY  CHANGE  PROBS  -  EVACUATION 


TRIAL 

NORMAL 

LOW  PROF 

MED  PROF 

EVAC  PST 

0 

-27 

-29 

-26 

-28 

1 

-39 

-35 

-26 

-27 

2 

-36 

-36 

-26 

-28 

3 

-27 

-28 

-26 

-28 

Figure  6.1-B 

SENSITIVITY  ANALYSIS:  EXAMPLE  OF  OUTPUT  FROM  FUNCTION  6.1 
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The  results  of  these  operations  are  derived  for  display  purposes  only  and  are 
temporary  values.  The  weights  (WEIGHTS)  and  probabilities  (PROBS)  of  the 
current  model  are  never  modified  permanently  by  these  operations. 


Systeni/Program  QPINT _  Name  _ 

Diagram  ID  -&2J _  Description  — V-lry  Weights_Autorriatically 


SENSITIVITY  ANALYSIS 


EXPECTED  VALUE  WHEN  WEIGHT  OF  EXPOSURE  RISK  IS. 


0 

10 

20 

30 

40 

SO 

60 

70 

80 

90 

100 

NORMAL 

—22* 

-23* 

-25* 

-26* 

-2? 

-29 

-30 

-31 

-33 

-34 

-35 

LOWPROF 

-32 

-31 

-31 

-30 

-29 

-29 

-28 

-27 

-27 

-26 

-25 

MEDPROF 

-44 

-39 

-35 

-31 

-27* 

-23* 

-19* 

-15* 

-11 

-7 

-3 

EVACPST 

-49 

-44 

-40 

-35 

-30 

-25 

-20 

-15 

-10* 

-5* 

-1* 

t  t 


Figure  6.2.1 

SENSITIVITY  ANALYSIS:  EXAMPLE  OF  OUTPUT  FROM  FUNCTION  6.2.1 
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System  Program:  OPINT _  Name:  _ 

Diagram  ID  JL2J. _  Descr.pt, on  VafV  Probabilities  Automatically 


SENSITIVITY  ANALYSIS 


EXPECTED  VALUE  WHEN  PROBABILITY  OF  NONE  IS: 


0 

10 

20 

30 

40 

50 

60 

70 

B0 

90 

100 

NORMAL 

-57 

-51 

-45 

-40 

-34 

-28 

-23* 

-17* 

-11* 

-6* 

O* 

LOWPROF 

-50 

-46 

-42 

-38 

-34 

-29 

-25 

-21 

-17 

-13 

-9 

MEDPROF 

-27 

-27 

-27 

-26* 

-26* 

-25* 

-25 

-25 

-24 

-24 

-24 

EVACPST 

-26* 

-26* 

-26* 

-27 

-27 

-28 

-28 

-28 

-29 

-29 

-29 

I  1 


v _ i 


Figure  6.2.2 

SENSITIVITY  ANALYSIS:  EXAMPLE  OF  OUTPUT  FROM  FUNCTION  6.2.2 
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System 'Progi  am:  OPINT _ 

Diagram  ID:  — 7-.Q -  Description 


System  Program:  0P1NT _  Name: _ _ 

Diagram  ID  .  ?» 1 -  Description  -  foe  Model  Structure _ _ _ _ _ _  Page: 


System /Program:  OPINT _  Name: _ 

Oiagram  10:  -12 _  Descr.pt.on .CreateRegretJWatrices _ paqe: 


Regrets  are  entered  for  each  criterion,  one  row  (decison  alternative)  at  a  time. 
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System  Program:  QP1NT _ _  Name:  _ 

Diagram  ID  _ZJ _  nBtr..rt.»n  Set  Outcome  Probabilities 
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System /Progr am:  QPINT _  Name:  SHOWMAT 

Diagram  ID:  -SJ - Description — Display_a  Matrix _ 
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2.  Formatting  the  Matrix  for  display  requires  the  concatenation  of  character 
and  numerical  values  into  character  or  display  output. 


System/Program:  OflNT _  Name:  Wait _ 

Diagram  ID:  -1^ - Description _ Wait-f°^_a.^esPonse _ _ _  Page: 
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3.  Any  keyboard  input  or  a  specific  response  may  be  requested  of  the 
user  before  processing  can  continue. 
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System/Program :  OPINT _  Name:  MENU _ 

Diagram  10:  _§J> _  Description _ M_enu_Selecti°n  Routine _  Page- 
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System/Program:  OPWT _ _  Name:  NORMALIZE 

Diagram  ID:  _ fill _ Description  Normalize  Vector  Values _ 
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